Skip to content

feat: add local dev quickstart - unified compose, startup scripts, and guide#32

Open
limingjing6666 wants to merge 3 commits into
nageoffer:mainfrom
limingjing6666:feat/local-dev-quickstart
Open

feat: add local dev quickstart - unified compose, startup scripts, and guide#32
limingjing6666 wants to merge 3 commits into
nageoffer:mainfrom
limingjing6666:feat/local-dev-quickstart

Conversation

@limingjing6666

Copy link
Copy Markdown

@

Summary

降低本地开发门槛,让开发者 clone 后能一键启动完整环境。

Changes

新增文件

文件 说明
docker-compose.local.yml 统一编排 PostgreSQL + Redis + RustFS + Milvus + RocketMQ,docker compose up -d 一次全起
scripts/start-local.sh macOS/Linux 一键启动脚本,自动检测环境 → 起容器 → 编译 → 启后端 + 前端
scripts/start-local.ps1 Windows PowerShell 启动脚本
docs/LOCAL_DEV.md 详细本地启动教程,含环境准备、编译修复、服务启动、验证步骤、FAQ

Quick Start (with this PR)

# 1. 一键启动所有基础设施
docker compose -f docker-compose.local.yml up -d

# 2. 一键启动所有应用服务
./scripts/start-local.sh          # macOS/Linux
#
.\scripts\start-local.ps1         # Windows

然后浏览器打开 http://localhost:5173,admin/admin 登录。

Service Layout

服务 端口
主应用 9090
MCP Server 9099
前端 (Vite) 5173
PostgreSQL 5432
Redis 6379
RocketMQ 9876
Milvus 19530
RustFS (S3) 9000

Verification

  • docker compose -f docker-compose.local.yml up -d 全部容器健康启动
  • ./mvnw clean install -DskipTests BUILD SUCCESS
  • ✅ 后端 API 登录成功 (admin/admin)
  • ✅ 前端页面正常渲染

🤖 Generated with Claude Code
@

limingjing6666 and others added 2 commits May 9, 2026 23:53
@
fix: add missing Guava version and jspecify dependency

- Guava dependency lacked <version> tag, causing Maven compilation failure
- jspecify is an optional transitive dependency of Guava not resolved automatically
- ApplicationContextHolder uses @nonnull from jspecify, causing "symbol not found"

Both issues block compilation with "mvn clean install" on any machine.

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
@
@
feat: add local dev quickstart with unified compose and startup scripts

- docker-compose.local.yml: one-command start for all infrastructure
  (PostgreSQL, Redis, RustFS, Milvus, RocketMQ)
- scripts/start-local.sh: macOS/Linux one-click startup script
- scripts/start-local.ps1: Windows PowerShell startup script
- docs/LOCAL_DEV.md: detailed local development guide covering
  prerequisites, build fixes, service startup, and troubleshooting

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
@
Copilot AI review requested due to automatic review settings May 9, 2026 15:59
This reverts commit 4ff6afe.

Copilot AI left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Copilot encountered an error and was unable to review this pull request. You can try again by re-requesting a review.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants